home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / TOOLS / MSA141 / SHADOW.DOC < prev    next >
Text File  |  1998-03-14  |  10KB  |  274 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                            COPYRIGHT NOTICE
  9.  
  10.      Magic Shadow Archiver hereafter referred to as MSA is Copyright 
  11. (C) 1987 by Steve Feinstein.  MSA is distributed under the User 
  12. Supported software or 'Shareware' concept.  If you find this program 
  13. useful and decide to keep and use it please compensate the author for 
  14. his efforts and register by sending a check or money order for the sum 
  15. of $10.00 to:
  16.  
  17.                             Steve Feinstein
  18.                            56-26 244 Street
  19.                          Douglaston, New York
  20.                                  11362
  21.  
  22.  
  23.      MSA may be copied and distributed freely provided it is not 
  24. modified and this documentation is included along with the two program 
  25. files.
  26.  
  27.      MSA may not be included with any other product for any reason 
  28. whatsoever without the written permission of the author. 
  29.  
  30.      No charge may be levied for a disk containing MSA except for a 
  31. disk handling charge of up to $8.00.
  32.  
  33.      With all the various emulations that are being implemented on the 
  34. ST the need for a means of transferring or storing data contained on 
  35. disks of the various system formats, easily, from TOS has become a 
  36. necessity.  MSA is an attempt to satisfy this need.
  37.  
  38.      Though all precautions have been taken to insure that MSA will 
  39. function properly the author cannot accept any responsibility for any 
  40. damages that may result from it's use or missuse.
  41.  
  42.    Please report any bugs and/or suggestions by dropping a note to the 
  43. above address.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.            T h e   M a g i c   S h a d o w   A r c h i v e r
  62.  
  63.  
  64.  
  65.      MSA creates an image file of any unprotected disk that contains 
  66. 512 byte sectors and writes it to a standard ST file using a simple 
  67. track compression algorithm.  This includes disks written under:
  68.  
  69.                 Atari ST/TOS
  70.                 Magic Sac
  71.                 IBM/MS-DOS
  72.                 CP/M
  73.  
  74.      This means you can store or backup and then re-create any 
  75. unprotected disk of various operating systems directly from the ST 
  76. desktop.  For instance bulletin boards can now easily handle files of 
  77. entire Public Domain, Share Ware or Demo program disks in Magic Sac, 
  78. IBM, TOS and other formats which can be Up/Downloaded and then restored 
  79. to their original form ready to use with all boot sectors, roots and 
  80. subdirectories intact.
  81.  
  82.  
  83.                                Using MSA
  84.  
  85. STORING A DISK - To create an MSA archive file just boot MSA.PRG and 
  86. after the functions panel appears place the disk you want to archive 
  87. into the source drive A or B (this may be set using the buttons in the 
  88. 'Drive' box at lower right off the panel - the default is drive A).  To 
  89. enter a name for your MSA archive file and set the destination 
  90. drive/partition click on the long rectangular box at the bottom of the 
  91. main panel and a standard GEM directory box will appear.  Click on OK 
  92. when you are finished making your entries.  The name FILENAME.MSA will 
  93. be used if you neglect to enter your own filename.
  94.  
  95.      At this point you can click on the 'Do it!' button and MSA will 
  96. start off by checking the source disk's format and display how many 
  97. sides, tracks and sectors per track in the 'Information' area.  MSA 
  98. will then continue by reading each track of the source disk writing to 
  99. the destination drive/file as it goes.  To the right of 'Information' 
  100. area you will see four fields that display the track being 
  101. read/written, the side, the status of the operation (will show error 
  102. codes if they occur) and the compression effectiveness for each track.  
  103.  
  104.      When the archiving operation is finished you will be presented 
  105. with a box showing the size of the original disk, the size of the MSA 
  106. file and the total compression acheived.  This file now contains an 
  107. image of your disk including the format information that will be used 
  108. by the 'AUTO-FORMAT' function to re-create it.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                   Re-creating A Disk From an MSA File
  121.  
  122.  
  123.      To re-create a disk from a stored MSA file place a blank disk into 
  124. the destination drive (set A or B by using the 'Drive' box at the lower 
  125. right of the main panel) and click on the 'DISK -> FILE' button at the 
  126. lower left of the panel.  This will change the button's markings to 
  127. 'FILE -> DISK' and the 'AUTO-FORMAT' button to the right will become 
  128. enabled.  Enter the name of your stored MSA file and source drive that 
  129. you will be restoring from by clicking on the filename box at the 
  130. bottom of the panel.  Now click on 'Do it!'.  MSA will format and 
  131. create a new disk which should be an exact image of the original.
  132.  
  133.  
  134.                                Features
  135.  
  136.      There are a number of user selectable or editable options that you 
  137. will find useful when using MSA.
  138.  
  139. ANALYZE - The 'Analyze' button allows you to check the format of a 
  140. source disk before actually creating an MSA archival file.  Place your 
  141. source disk in the selected drive (A or B) and click on 'Analyze'.
  142. The number of sides, number of tracks and sectors per track will be 
  143. displayed in the 'Information' area.
  144.  
  145.      MSA uses this function automatically (unless the 'Override' button is 
  146. set) when creating an archive file.  The 'ANALYZE' feature works on 
  147. most standard formats used in the above operating systems.  MSA will 
  148. 'Automatically' copy and restore disks within these format ranges:
  149.  
  150.            Single/Double sided
  151.            80 tracks or more per side
  152.            8 or more sectors per track (512 bytes per sector)
  153.            (11 [or more] sector destination disks must be
  154.             pre-formatted.)
  155.  
  156.      Since the operating speed of MSA was of major concern the analysis 
  157. was kept within these ranges. (Forty track IBM disks may be set using 
  158. the 'Override' button.)   Because MSA is intended to work on different 
  159. system disks the format analysis is made of the physical track/sector 
  160. format of the disk and not through the system format data on the disk.  
  161. Disks that have been formatted and reformatted with various capacities 
  162. or systems can fool MSA into doing the wrong thing.  Usually you will 
  163. end up with an unecessarily large file but care must be taken to insure 
  164. that these messy disks are stored properly by using the 'Override' 
  165. feature and entering the format parameters manually.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                               Compression
  178.  
  179.  
  180.      At this time MSA uses a rather rudimentary data compression 
  181. algorythm.  It simply checks for strings of contiguous bytes of similar 
  182. value and stores them in short encripted form.
  183.  
  184.       Disks containing many empty sectors or repeated bytes (such as 
  185. graphics files) will result in the smallest files.  You can further 
  186. compress your MSA files by using other compression programs such as 
  187. arc.ttp, arca.ttp, etc.  Note: smaller systems may not be able to arc 
  188. the larger files created by MSA as with double sided disk files.  These 
  189. disks may be stored in segments or sections.  i.e. tracks 0-39 as 
  190. FILE_A.MSA and 40-79 as FILE_B.MSA on a DS/80 track disk.
  191.  
  192.  
  193.                         Segmenting A Disk Image
  194.  
  195.      To break a disk down into multiple MSA files click on and 'select' 
  196. the 'Override' button before you start the archival operation.  Then set 
  197. the starting and ending tracks by clicking on the 'Tracks:' field.  
  198. Change the starting and ending tracks to your needs and after placing 
  199. the source disk in the drive proceed normally by clicking on the 'Do 
  200. it!' button.  Remember to use descriptive names for each section of the 
  201. disk saved (for your own reference).  MSA handles all the rest.  MSA's 
  202. 'Auto-Format' feature will restore each section to it's proper position 
  203. on the disk when recreating the disk.  Sequence is not important.
  204.  
  205.  
  206.                        The Manual Override Button
  207.  
  208.      The auto-analyze feature can be toggled off by clicking on the 
  209. 'Override' button.  This will deselect this feature.  This is useful 
  210. when storing disks that have previously been formatted as double sided 
  211. but now contain single sided information.  i.e. A disk that was used as 
  212. a double sided TOS disk and then used as single sided Magic Sac disk 
  213. containing ported Mac program files.
  214.  
  215.      If MSA finds a second side on a single sided format it WILL copy 
  216. it so use the 'Override' to set MSA for 1 side if that is all you want 
  217. stored.  An easy way to check is to use the 'Analyze' feature alone 
  218. before you start actually storing the disk.  This will tell you if MSA 
  219. thinks there is a second side.
  220.  
  221.  
  222.                          Aborting An Operation
  223.  
  224.      Pressing and holding down either mouse button will abort a store 
  225. or restore operation if you need to do so.  When the disk is being 
  226. checked with the 'Analyze' feature you must wait for it's completion 
  227. before you can abort. 
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                           IBM or MS-DOS disks
  235.  
  236.      MS-DOS or IBM program disks are usually double sided but often use 
  237. only forty tracks (0-39).  You can save time as well as avoid an 
  238. oversized MSA file by manually setting MSA for 40 tracks.  I'm sure 
  239. that many PC-Ditto disks have previously lead lives as ST TOS disks.  
  240.  
  241.      Standard format for IBM or MS-DOS (v3.x) disks:
  242.  
  243.           Tracks 40
  244.           Sides   2
  245.           Sectors 9
  246.  
  247.      
  248.  
  249.                            DOS system disks
  250.  
  251.      IBM DOS system disks can be copied and restored with the system 
  252. boot sectors and DOS version formats intact and ready to run.  MSA may 
  253. also be used with 5.25" drives.
  254.  
  255.  
  256.                             Magic Sac disks
  257.  
  258.      Magic Sac disk format is as follows:
  259.  
  260.         Tracks    80
  261.         Sectors   10
  262.         Sides     1 or 2
  263.  
  264.      One of MSA's most useful applications is the transferring of Magic 
  265. Sac disks.
  266.  
  267.      We feel that the Magic Shadow Archiver will quickly find a place 
  268. in your utilities box as you discover more ways using it.  Please feel 
  269. free to drop us a note regarding any problems as well as suggestions
  270. for improvements.
  271.  
  272.  
  273.                                           Bill Kokoni
  274.